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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management, as identified below: 

32.341: "File Transfer (FT) Integration Reference Point (IRP): Requirements" 

32.342: "File Transfer (FT) Integration Reference Point (IRP): Information Service (IS)" 

32.346: "File Transfer (FT) Integration Reference Point (IRP): Solution Set (SS) definitions" 

The present document is part of a TS-family which describe the requirements and information model necessary for the 
Telecommunication Management (TM) of 3G systems. The TM principles and TM architecture are specified in 
3GPP TS 32.101 [1] and 3GPP TS 32.102 [2]. 

Network Elements (NEs) under management, element managers as well as network managers generate various 
management information stored in file format. This IRP is addressing how these files are exchanged through Itf-N as 
well as certain aspects of file management and maintenance. It is anticipated that management functions (e.g. PM, Call 
Trace, CM) make reuse of capabilities provided by this File Transfer IRP. 
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Scope 



The present document contains the Solution Sets for the IRP whose semantics are specified in File Transfer IRP: 
Information Service (3GPP TS 32.342 [15]). 

This Solution Set specification is related to 3GPP TS 32.342 VI l.O.X. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) 
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• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 
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[17] 3GPP TS 32.331: "Telecommunication management; Notification Log (NL) Integration Reference 

Point (IRP): Requirements". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
3GPP TS 32.150 [9], 3GPP TS 32.331 [17] and 3GPP TS 32.341 [3] and the following apply: 

IRP document version number string (or "IRPVersion"): See 3GPP TS 32.31 1 [4]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CM Configuration Management 

CORBA Common Object Request Broker Architecture 

DN Distinguished Name 

FT File Transfer 

FTIRP File Transfer IRP 

IDL Interface Definition Language 

IRP Integration Reference Point 

IS Information Service 

NE Network Element 

NL Notification Log 

NRM Network Resource Model 

OMG Object Management Group 

PM Performance Management 

SS Solution Set 

UML Unified Modelling Language 

WSDL Web Service Description Language 

XML extensible Markup Language 

4 Solution Set Definitions 

This specification defines the following 3GPP FT IRP Solution Set Definitions: 

Annex A provides the CORBA Solution Set. 
Annex B provides the XML Definitions. 
Annex C provides the SOAP Solution Set. 
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Annex A (normative): 
CORBA Solution Set 



This annex contains the CORBA Solution Set for the IRP whose semantics is specified in FT IRP: Information Service 
(3GPPTS 32.342 [15]). 



A.1 Architectural features 

The overall architectural feature of FT IRP is specified in 3GPP TS 32.341 [3]. 
This clause specifies features that are specific to the CORBA SS. 

A.1 .1 Syntax for Distinguished Names 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300 [6]. 

A. 1.2 Notification Services 

In implementations of CORBA SS, IRP Agent conveys FT Information to IRPManager via OMG Notification Service 
(OMG Notification Service [10]). 

A necessary and sufficient sub set of OMG Notification Services shall be used to support 
FileTransf erIRPNotif ications notifications as specified in 3GPP TS 32.342 [15]. 

A.1. 3 Push and Pull Style 

OMG Notification Service defines two styles of interaction. One is called push style. In this style, IRP Agent pushes 
notifications to IRPManager as soon as they are available. The other is called pull style. In this style, IRP Agent keeps 
the notifications till IRPManager requests for them. 

This CORBA SS specifies that support of Push style is Mandatory (M) and that support of Pull style is Optional (O). 

A.1 .4 Support multiple notifications in one push operation 

For efficiency reasons, IRP Agent may send multiple notifications using one single push operation. To pack multiple 
notifications into one push operation, IRP Agent may wait and not invoke the push operation as soon as notifications are 
available. To avoid IRP Agent to wait for an extended period of time that is objectionable to IRPManager, IRP Agent 
shall implement an IRP Agent wide timer configurable by administrator. On expiration of this timer, IRP Agent shall 
invoke push if there is at least one notification to be conveyed to IRPManager. This timer is re-started after each push 
invocation. 

A.1. 5 FileTransferlRP Notification Interface 

OMG CORBA Notification push operation is used to realise the notification of FileTransferlRP Notifications. All the 
notifications in this interface are implemented using this push_structured_event method. 

A.1. 5.1 Method push (M) 

module CosNotifyComm { 

Interface SequencePushConsumer : NotifyPublish { 
void push_structured_events ( 

in CosNotif ication: :EventBatch notifications) 
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raises { CosEventComm: : Disconnected) ; 
} ; // SequencePushConsumer 
} ; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [10]). This data type is the same 
as a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 



A.2 Mapping 

A.2.1 Operation and Notification mapping 

FileTransferlRP: IS 3GPP TS 32.342 [15] defines semantics of operation and notification visible across the 
FileTransferlRP. Table A.2.1 indicates mapping of these operations and notifications to their equivalents defined in this 
SS. 

Table A.2.1 : Mapping from IS Operations and Notification to SS equivalents 



IS Operations/ notification 3GPP TS 32.342 [15] 


SS Method 


Qualifier 


listAvailableFiles 


list available files 


M 


fileDownloadlndication 


file download indication 





getlRPVersion (see note) 


get file transfer irp versions 


M 


getOperationProfile (see note) 


get file transfer irp operations profile 





getNotificationProfile (see note) 


get file transfer irp notifications profile 





notifyFileReady 


push structured events (see subclause A.1. 5) 


M 


notifyFilePreparationError 


push structured events (see subclause A.I .5) 


M 


NOTE: This operation is of IVIanagedGenericIRP IOC specified in 3GPP TS 32.312 [7]. The FileTransferlRP IOC of 
3GPP TS 32.342 [15] inherits from it. 



A.2. 2 Operation parameter mapping 



The FileTransferlRP: IS 3GPP TS 32.342 [15] defines semantics of parameters carried in operations across the 
FileTransferlRP. The following tables indicate the mapping of these parameters, as per operation, to their equivalents 
defined in this SS. 

Table A.2.2.1 : lUlapping from IS listAvailableFiles parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managementDataType 


short management data type 


M 


beginTime 


FileTransferlRPConstDefs::UTCTime begin time 


M 


endTime 


FileTransferlRPConstDefs::UTCTime end time 


M 


filelnfoList 


FileTransferlRPConstDefs::FilelnfoListfile info list 


M 


status 


Return value of type FileTransferlRPConstDefs::Result 

Exception: 

ListAvailableFiles, InvalidTimes, IVIanagedGenericlRPSystem::lnvalidParameter 


M 
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Table A.2.2.2: Mapping from IS flleDownloadindlcatlon parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


filelnfoList 


FileTransferlRPConstDefs::FilelnfoListfile info list 


M 


status 


Return value of type FileTransferlRPConstDefs::Result 

Exception: 

FileDownloadlndication, InvalidFilelnfoList, 

IVIanagedGenericI RPSystem :OperationNotSupported 


M 



Table A.2.2.3: IVIapping from IS getiRPVerslon parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberSet 


Return value of type IVlanagedGenericlRPConstDefs::VersionNumberSet 


M 


status 


Exception: 
GetFileTransferlRPVersions 


M 



Table A.2.2.4: Mapping from IS getoperationProflle parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


ManagedGenericlRPConstDefs::VersionNumber irp version 


M 


operationNameProfile, 
operationParameterProfile 


Return value of type l\/lanagedGenericlRPGonstDefs::MethodList 


M 


status 


Exception: 

GetFileTransferlRPOperationsProfile, 

ManagedGenericlRPSystem::OperationNotSupported, 

IVIanagedGenericlRPSystem::lnvalidParameter 


M 



Table A.2.2.5: Mapping from IS getNotlflcatlonProf lie parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


ManagedGenericlRPConstDefs::VersionNumber irp version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type IVIanagedGenericI RPConstDefs::MethodUst 


M 


status 


Exception: 

GetFileTransferlRPNotificationsProfile, 

ManagedGenericlRPSystem::OperationNotSupported, 

IVIanagedGenericlRPSystem::lnvalidParameter 


M 



A.2.3 Notification parameter mapping 



The FileTransferlRP: IS 3GPP TS 32.342 [15] defines semantics of parameters carried in notifications. The following 
table indicates the mapping of these parameters to their OMG CORB A Structured Event (defined in OMG Notification 
Service [10]) equivalents. The composition of OMG Structured Event, as defined in the OMG Notification Service [10], 
is: 



Header 



Body 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f ilterable_body_f ields 
remaining_body 



The following tables list all OMG Structured Event attributes in the second column. The first column identifies the 
FileTransferlRP: IS 3GPP TS 32.342 [15] defined notification parameters. 
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Table A.2.3.1 : Mapping for notifyFileReaciy 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 


M 


It carries the IRP document version number string. See 
subclause 3.1. 

It indicates the syntax and semantics of the Structured Event as 
defined by the present document. 


notificationType 


type_name 


M 


This is the ET_FILE_READY of module of 
FileTransferlRPNotifDefs. 


There is no 
corresponding IS 
attribute. 


event_nanne 


M 


It carries no information. 


There is no 
corresponding IS 
attribute. 


Variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs 
is not significant. The name of NV-pair is always encoded in 
string. 

Name of this NV pair is the MANAGED_OBJECT_INSTANCE 
of interface AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.306 [5]). 


notificationid 


One NV pair of 
remaining_body 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.306 [5]). 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the EVENT_TIME of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.306 [5]). 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEIVI_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.306 [5]). 


filelnfoList 


One NV pair of 
remaining_body 


M 


Name of NV pair is the FILE_INFO_LIST of interface 
NotifyFileReady of module FileTransferlRPNotifications. 

Value of NV pair is FilelnfoList of module 
FileTransferlRPConstDefs. 


additionalText 


One NV pair of 
remaining_body 





Name of NV pair is the ADDITIONAL_TEXT interface 
NotifyFileReady of module FileTransferlRPNotifications. 

Value of NV pair is a string. 



Table A.2.3.2: Mapping for notifyFilePreparationError 



IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


domain_name 


M 


It carries the IRP document version number string. See 
subclause 3.1. 

It indicates the syntax and semantics of the Structured Event as 
defined by the present document. 


notificationType 


Type_name 


M 


This is the ET_FILE_PREPARATION_ERROR of module of 
FileTransferlRPNotifDefs. 


There is no 
corresponding IS 
attribute. 


event_name 


M 


It carries no information. 
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IS Parameters 


OMG CORBA 

Structured Event 

attribute 


Qualifier 


Comment 


There is no 
corresponding IS 
attribute. 


Variable Header 






objectClass, 
objectlnstance 


One NV pair of 
filterable_body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs 
is not significant. The name of NV-pair is always encoded in 
string. 

Name of this NV pair is the MANAGED_OBJECT_INSTANCE 
of interface AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.306 [5]). 


notificationid 


One NV pair of 
remainingbody 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.306 [5]). 


eventTime 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the EVENT_TIIVIE of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.306 [5]). 


systemDN 


One NV pair of 
filterable_body_fields 


M 


Name of NV pair is the SYSTEIVI_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS (3GPP TS 32.306 [5]). 


filelnfoList 


One NV pair of 
remaining_body 


M 


Name of NV pair is the FILE_INFO_LIST of interface 
NotifyFilePreparationError of module 
FileTransferlRPNotifications. 

Value of NV pair is FilelnfoList of module 
FileTransferlRPConstDefs. 


reason 


One NV pair of 
remaining_body 


M 


Name of NV pair is the REASON of interface 
NotifyFilePreparationError of module 
FileTransferlRPNotifications. 

Value of NV pair is a string. 


additionalText 


One NV pair of 
remaining_body 





Name of NV pair is the ADDITIONAL_TEXT of interface 
NotifyFilePreparationError of module 
FileTransferlRPNotifications. 

Value of NV pair is a string. 



A. 3 Solution Set definitions 
A.3.1 IDL definition structure 

Clause A. 3. 2 defines the constants and types used by the FT IRP. 

Clause A. 3. 3 defines the operations which are performed by the FT IRP agent. 

Clause A. 3. 4 defines the notifications which are emitted by the FT IRP agent. 
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A.3.2 IDL specification "FileTransferlRPConstDefs.idl" 

//File : FileTransf erIRPConstDef s . idl 
iifndef _FILE_TRANSFER_IRP_CONST_DEFS_IDL_ 
idefine _FILE_TRANSFER_IRP_CONST_DEFS_IDL_ 

#include <TimeBase . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: FileTransf erIRPConstDef s 

This module contains commonly used definitions for FileTransf erIRP . 

*/ 

module FileTransf erIRPConstDef s 

{ 

enum Result {OK, FAILURE}, - 

typedef TimeBase : :UtcT UTCTime; 

enum LocationChoice {DIRECTORY, URL}; 

//The FileLocation may be a directory path or a URL 
union FileLocation switch (LocationChoice) 

{ 

case DIRECTORY: string f ile_location_directory,- 

/* e.g. \\202 . 112 . 101. 1\D: \user\performanceFiles\<f ileName> */ 

case URL: string f ile_location_url; 

/* e.g. f tp : //nms . telecom_org. com/datastore/<f ileName> */ 



typedef unsigned long FileSize; //the unit is byte 
typedef string FileCompression; 
typedef string FileFormat; 

struct Filelnfo 

{ 

FileLocation f ile_location; 
FileSize file_size; 
UTCTime f ile_ready_time; 
UTCTime f ile_expiration_time,• 
FileCompression f ile_compression,• 
FileFormat file format ; 



typedef sequence<FileInf o> Filelnf oList ; 



const 


short 


PM 


MANAGEMENT 


DATA 


TYPE = 


1, 


const 


short 


CM 


MANAGEMENT 


DATA 


TYPE = 


2, 


const 


short 


IM 


MANAGEMENT 


DATA 


TYPE = 


3, 


const 


short 


TM 


MANAGEMENT 


DATA 


TYPE = 


4, 


const 


short 


CT 


MANAGEMENT 


DATA 


TYPE = 


5, 


const 


short 


NL 


MANAGEMENT 


DATA 


TYPE = 


s. 


const 


short 


CG 


MANAGEMENT 


DATA 


TYPE = 


7, 


const 


short 


OT 


MANAGEMENT 


DATA 


TYPE = 


8, 



//Performance Management 
//Configuration Management 
//Inventory Management 
//Test Management 
//Subscriber & Equipment Trace 
//Notification Log 
//Charging 
//Other Types 



Define the parameters specified in the notifyFileReady 

and notifyFilePreparationError notifications. 

*/ 

interface AttributeNameValue 

{ 

const string FILE_INFO_LIST = "FILE_INFO_LIST" ; 
const string ADDITIONAL_TEXT = "ADDITIONAL_TEXT" ; 
const string REASON = "REASON" ,- 



}; 



#endif // _FILE_TRANSFER_IRP_CONST_DEFS_IDL_ 
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A.3.3 IDL specification "FileTransferlRPSystem.idl" 

//File : FileTransf erIRPSystem. idl 
#ifndef _FILE_TRANSFER_IRP_SYSTEM_IDL_ 
idefine _FILE_TRANSFER_IRP_SYSTEM_IDL_ 

#include <ManagedGenericIRPConstDef s . idl> 
#include <ManagedGenericIRPSystem. idl> 
#include <FileTransf erIRPConstDef s . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: FileTransf erIRPSystem 

This module implements capabilities of FileTransf erIRP . 



*/ 

module FileTransf erIRPSystem 

{ 

exception InvalidTimes { string reason; } ; 
exception InvalidFilelnfoList { string reason; }; 

/* 

System fails to complete the operation. System can provide reason 

to qualify the exception. The semantics carried in reason 

is outside the scope of this IRP. 

*/ 

exception ListAvailableFiles { string reason; }; 

exception FileDownloadlndication { string reason; }; 

exception GetFileTransf erIRPVersions { string reason; }; 

exception GetFileTransf erIRPOperationsProfile { string reason; }; 

exception GetFileTransf erIRPNotificationsProfile { string reason; } 

interface FileTransf erIRP 

{ 

/* 

* IRPManager invoke this operation to get the files information 

*/ 

FileTransf erIRPConstDef s : : Result list_available_f iles { 

in short management_data_type, 

in FileTransf erIRPConstDef s : lUTCTime begin_time, 



UTCTime end_time, 
: FilelnfoList file info list 



in FileTransf erIRPConstDef s : 

out FileTransferlRPConstDef s _ _ 

) 
raises {ListAvailableFiles, InvalidTimes, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

* IRPManager invoke this operation to indicate completion of downloading files to IRPAgent 
*/ 

FileTransf erIRPConstDef s : : Result f ile_download_indication { 

in FileTransf erIRPConstDef s :: FilelnfoList f ile_info_list 
) 
raises {FileDownloadlndication, InvalidFilelnfoList, 

ManagedGenericIRPSystem: :OperationNotSupported) ; 

/** 

* Return the list of all supported FileTransf erIRP versions. 

ManagedGenericIRPConstDef s : :VersionNumberSet get_f ile_transf er_irp_versions { 

) 

raises {GetFileTransf erIRPVersions) ; 

/** 

* Return the list of all supported operations and their supported 

* parameters for a specific FileTransf erIRP version. 
*/ 

ManagedGenericIRPConstDef s : :MethodList get_f ile_transf er_irp_operations_prof ile { 

in ManagedGenericIRPConstDef s : :VersionNumber irp_version 
) 
raises {GetFileTransf erIRPOperationsProfile , 

ManagedGenericIRPSystem: :OperationNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/** 

* Return the list of all supported notifications and their supported 

* parameters for a specific FileTransf erIRP version. 



£75/ 



3GPP TS 32.346 version 1 1 .0.0 Release 11 15 ETSI TS 1 32 346 V1 1 .0.0 (201 2-1 0) 

*/ 

ManagedGenericIRPConstDef s : iMethodList get_f ile_transf er_irp_notif ications_prof ile 
{ 

in ManagedGenericIRPConstDef s : iVersionNumber irp_version 
) 
raises {GetFileTransf erIRPNot if icat ions Prof ile, 

ManagedGenericIRPSystem: lOperationNot Supported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 



#endif // _FILE_TRANSFER_IRP_SYSTEM_IDL_ 



A.3.4 IDL specification "FileTransferlRPNotifications.idI" 

//File : FileTransf erIRPNotif ications . idl 
#ifndef _FILE_TRANSFER_IRP_NOTIFICATIONS_IDL_ 
#define _FILE_TRANSFER_IRP_NOTIFICATIONS_IDL_ 

#include <FileTransf erIRPConstDef s . idl> 
#include <NotificationIRPNotif ications . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: FileTransf erIRPNotif ications 

This contains the specification of notifications of FileTransf erIRP . 



*/ 

module FileTransf erIRPNotif ications 

{ 

/** 

* Constant definitions for the FileReady notification 

*/ 

interface NotifyFileReady : NotificationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyFileReady" ; 

/** 

* This constant defines the name of the filelnfoList property, 

* which is transported in the f ilterable_body fields. 

* The data type for the value of this property is 

* FileTransf erIRPConstDef s : : FilelnfoList . 

const string FILE_INFO_LIST = 

FileTransf erIRPConstDef s : lAttributeName Value : : FILE_INFO_LIST; 

/** 

* This constant defines the name of the additionalText property, 

* which is transported in the f ilterable_body fields. 

* The data type for the value of this property is string. 
*/ 

const string ADDITIONAL_TEXT = 

FileTransf erIRPConstDef s: lAttributeName Value : lADDITIONAL TEXT; 



/** 

* Constant definitions for the FilePreparationError notification 
*/ 

interface Notif yFilePreparationError : 
NotificationlRPNotif ications : iNotify 

{ 

const string EVENT_TYPE = "notifyFilePreparationError" ; 

/** 

* This constant defines the name of the filelnfoList property, 

* which is transported in the f ilterable_body fields. 

* The data type for the value of this property is 

* FileTransf erIRPConstDef s : : FilelnfoList . 
*/ 

const string FILE_INFO_LIST = 

FileTransferlRPConstDef s : lAttributeNameValue : :FILE INFO LIST; 
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/** 

* This constant defines the name of the reason property, 

* which is transported in the f ilterable_body fields. 

* The data type for the value of this property is string. 
*/ 

const string REASON = 

FileTransferlRPConstDef s : lAttributeName Value : iREASON; 

/** 

* This constant defines the name of the additionalText property, 

* which is transported in the f ilterable_body fields. 

* The data type for the value of this property is string. 
*/ 

const string ADDITIONAL_TEXT = 

FileTransferlRPConstDefs: lAttributeName Value : lADDITIONAL TEXT; 



#endif // FILE TRANSFER_IRP_NOTIFICATIONS_IDL_ 
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Annex B (normative): 
XML Definitions 



This annex contains the XML Definitions for the File Transfer Integration Reference Point (FT IRP) as it applies to Itf- 
N, in accordance with FT IRP IS definitions [15] as well as Notification Log IRP XML Definitions [16]. 

Apart from being used for the Notification Log, the XML definitions for FT IRP notifications are also used by the FT 
IRP SOAP SS. 



B.1 Architectural Features 

The overall architectural feature of FT IRP is specified in 3G TS 32.342 [15]. This clause specifies features that are 
specific to the XML definitions. 

B.1 .1 Syntax for Distinguished Names 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300 [6]. 

B.1. 2 Notification Services 

This annex defines the XML syntax of FT IRP notifications that is to be used for the FT IRP SOAP Solution Set and in 
conjunction with Notification Log IRP XML Definitions for Notification Log IRP XML Data File and the NL IRP 
XML Notification Format [16]. 

B.1. 3 IOC Definitions 

This annex defines the XML syntax for the IOC definitions of the FT IRP IS [15], which are used by the XML 
definitions for the FT IRP notifications and the FT IRP IS operations. 



B.2 Mapping 

Not present in the current version of this specification. 



B.3 Solution Set definitions 
B.3.1 XML definition structure 

Clause B.3. 2 provides a graphical representation of the XML elements. 

Clause B.3. 3 provides XML definitions of FT IRP notifications as defined in [15]. These definitions are to be used for 
the FT IRP SOAP Solution Set and in conjunction with Notification Log IRP XML Definitions for Notification Log 
IRP XML Data File and the NL IRP XML Notification Format [16], as well as considerations for NL IRP XML File 
Name Conventions defined therein. 

Clause B.3. 4 provides XML definitions of FT IOC as defined in [15]. 
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B.3.2 Graphical Representation 
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Figure B.3.2. 1 
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Figure B.3.2.2 

NOTE: The use of XML schema key word "sequence" to support IS-defined set (not sequence) is for the purpose 
of XML processor efficiency. This shall not imply the use of "sequence" in other technology. 

B.3.3 XIVIL Schema 'fTIRPNotif.xsd' 

<?xml version="l . 0" encoding="UTF-8" ?> 
< 1 - - 

3GPP TS 32.346 FTIRP Notification XML Schema 
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fTIRPNotif .xsd 

- - > 

< schema xmlns :xf ="http : //www. 3gpp .org/f tp/specs/archive/32_series/32 . 34 6#fTIRPNotif " 

xmlns :xf i="http: //www. 3gpp . org/f tp/ specs /archive/ 3 2_series/3 2 . 34 6#fTIRPIOCs" 

xmlns :xe="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 3 6#notif ication" 

xmlns="http: //www.w3 . org/2 01/XMLSchema" 

targetNamespace="http : //www. 3gpp .org/f tp/specs/archive/32_series/ 32 . 34 6#fTIRPNotif " 

elementFormDefault= "qualified" attributeFormDefault=" unqualified" > 

< import namespace="http : //www. 3gpp .org/f tp/ specs /archive/ 3 2_series/3 2 . 346#fTIRPIOCs"/> 
< import namespace="http : //www. 3gpp.org/ftp/specs/archive/32_series/32 . 3 06#not if ication" /> 
<simpleType name="Reason" > 

<restriction base="string" > 

< enumeration value="errorInPreparation"/> 
< enumeration value="hardDiskFull"/> 
< enumeration value="hardDiskFailure"/> 
<enumeration value="tooManyFiles"/> 
<enumeration value="collectionTimeOut"/> 
< enumeration value="incompleteTruncatedFile"/> 
<enumeration value="corruptedFile"/> 
< enumeration value="lowMemory"/> 
< enumeration value ="dataNot Aval lable"/> 
</restriction> 
</simpleType> 

<complexType name="NotifyFileReady" > 
<complexContent> 

<extension base="xe iNotif ication" > 
<sequence> 

<element name="body"> 
<complexType> 
<sequence> 

<element name="FileInfoList" type="xf i : FilelnfoList" maxOccurs="unbounded"/> 
<element name="AdditionalText" type=" string" minOccurs="0"/> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
</complexContent> 
</complexType> 

<complexType name="NotifyFilePreparationError" > 
<complexContent> 

<extension base="xe iNotif ication" > 
<sequence> 

<element name="body"> 
<complexType> 
<sequence> 

<element name="FileInfoList" type="xfi : FilelnfoList" minOccurs=" 0"/> 
<element name="Reason" type="xf :Reason"/> 

<element name="AdditionalText" type=" string" minOccurs=" 0"/> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
</complexContent> 
</complexType> 

<element name="NotifyFileReady" type="xf :NotifyFileReady"/> 

<element name="NotifyFilePreparationError" type="xf :NotifyFilePreparationError"/> 
</schema> 

B.3.4 XML Schema 'fTIRPIOCs.xsd' 

<?xml version="l . 0" encoding="UTF-8" ?> 
< ! - - 

3GPP TS 32.346 FTIRP Notification XML Schema 

fTIRPIOCs.xsd 

- - > 

< schema xmlns :xf i="http : //www. 3gpp .org/f tp/ specs /archive/3 2_series/3 2 . 34G#fTIRPIOCs" 
xmlns :xe="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 3 6#not if ication" 
xmlns="http: //www.w3 .org/2 01/XMLSchema" 

targetNamespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 346#fTIRPIOCs" 
elementFormDefault=" qualified" attributeFormDefault=" unqualified" > 
<simpleType name="FileFormat" > 
<restriction base="string" > 

<enumeration value="ASNl"/> 
< enumerat ion value = " XML - schema " / > 
</restriction> 
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</simpleType> 

<simpleType name="ManagementDataType" > 
<restriction base="string" > 

<enumeration value="CG"/> 

<enumeration value="CM"/> 

<enumeration value="CT"/> 

<enumeration value="Iiyi"/> 

<enumeration value="NL"/> 

<enumeration value="OT"/> 

<enumeration value="PM"/> 

<enumeration value="TE"/> 
</restriction> 
</simpleType> 

<complexType name="FileInfoList" > 
<sequence> 

< element name="ManagementDataType" type="xf i :ManagementDataType"/> 

<element name="FileSize" type="unsignedLong"/> 

<element name="FileCompression" type="string" minOccurs=" 0"/> 

<element name="FileReadyTime" type="dateTime"/> 

<element name="FileExpirationTime" type="dateTime"/> 

<element name="FileFormat" type="xf i : FileFormat"/> 

<element name="FileLocation" type="string"/> 
</sequence> 
</complexType> 

<!-- Attributes of the AvailableFileDescriptor IOC --> 
< e lement name= " managementDat aType " type = " xf i : ManagementDat aType " / > 
<element name="f ileSize" type="unsignedLong"/> 
<element name="f ileCompression" type=" string" /> 
<element name="f ileReadyTime" type="dateTime"/> 
<element name="f ileExpirationTime" type="dateTime"/> 
<element name="f ileFormat" type="xf i : FileFormat"/> 
<element name="f ileLocation" type="string"/> 
</schema> 
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Annex C (normative): 
SOAP Solution Set 



This annex specifies the SOAP Solution Set for the IRP whose semantics are specified in FT IRP: Information Service 
(3GPPTS 32.342 [15]). 



C.1 Architectural features 

The overall architectural feature of the FT IRP is specified in 3GPP TS 32.342 [15]. This clause specifies features that 
are specific to the SOAP Solution Set. 

C.1 .1 Syntax for Distinguished Names 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300 [6]. 

C.1. 2 Notification Services 

The FT IRP SOAP SS uses the Notification IRP SOAP SS of 3GPP TS 32.336 [16]. The IRPAgent shall support the 
push interface model, which means that the IRPAgent sends FT notifications to the IRPManager as soon as new events 
occur. The IRPManager does not need to check ("pull") for events. 

Relevant definitions are imported from the FT IRP XML definitions in Annex B. 

C.1 .3 Supported W3C specifications 

The SOAP 1.1 specification [11] and WSDL 1.1 specification [13] are supported. 

The SOAP 1.2 specification [14] is supported optionally. 

This specification uses "document" style in WSDL file. 

This specification uses "literal" encoding style in WSDL file. 

The filter language used in the SS is the XPath Language (see W3C XPath 1.0 specification [12]). IRP Agents may 
throw a FilterComplexityLimit fault when a given filter is too complex. 

The FT IRP SOAP SS uses the Notification IRP SOAP SS of 3GPP TS 32.336 [5]. The IRPAgent shall support the 
push interface model, which means that the IRPAgent sends FT notifications to the IRPManager as soon as new events 
occur. The IRPManager does not need to check ("pull") for events. 

C.1 .4 Prefixes and namespaces 

This specification uses a number of namespace prefixes throughout that are listed in Table C.1.4. 
Table C.1.4: Prefixes and Namespaces used in this specification 



PREFIX 


NAMESPACE 


(no prefix) 


http://schemas.xmlsoap.org/wsdl/ 


soap 


http://schemas.xmlsoap.org/wsdl/soap/ 


fTIRPSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/32.346#FTIRPSystem 


fTIRPData 


http://www.3gpp.org/ftp/specs/archive/32 series/32. 346#FTIRPData 


xfi 


http://www.3gpp.org/ftp/specs/archive/32 series/32.346#fTIRPIOCs 


genericlRPSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/32.31 6#GenericlRPSystem 


ntflRPNtfSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/32. 306#NotificationlRPNtfSystem 
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C.2 Mapping 

C.2.1 Operation and notification mapping 

The FT IRP IS (3GPP TS 32.342 [15]) defines the operations and their semantics. 

Table C.2.1 maps the operations defined in the FT IRP IS to their equivalent port type and binding operations in this 
Solution Set (SS). 

Table C.2.1 also maps the notifications of the FT IRP IS, as well as inherited operations. 

Table C.2.1 also qualifies if an operation is Mandatory (M) or Optional (O). 

Table C.2.1 : Mapping from IS Operation to SS Equivalents 



IS Operation in 3GPP TS 32.342 [15] 


SS: Operation for WSDL port 
type and WSDL binding 


SS: Port of 
FileTransferlRPService 


Qualifier 


listAvailableFiles 


listAvailableFiles (note 1) 


FileTransferlRPPort 


M 


fileDownloadlndication 


fileDownloadlndication (note 1) 


FileTransferlRPPort 





notifyFileReady 


notify (note 2) 


NotificationlRPNtfPort 


M 


notifyFilePreparationError 


notify (note 2) 


NotificationlRPNtfPort 


M 


getlRPVersion (note 3) 


See TS 32.316 [8] 


GenericlRPPort 


M 


getOperationProfile (note 3) 


See TS 32.316 [8] 


GenericlRPPort 





getNotificationProfile (note 3) 


See TS 32.316 [8] 


GenericlRPPort 





NOTE 1 : The operation is under the port type fTIRPSystem:FileTransferlRPPortType and under the binding 
fTIRPSystem:FileTransferlRPBinding. 


NOTE 2: The IS equivalent maps to an XML definition defined in Annex B, and this being an input parameter to the 
operation notify under the port type ntflRPNtfSystem:NotificationlRPNtf and under the binding 
ntflRPNtfSystem:NotificationlRPNtf of 3GPP TS 32.306 [5]. This binding is linked to a port of the 
FileTransferlRPService as indicated in the table above. 


NOTE 3: The IS operation is inherited from the ManagedGenericIRP IOC specified in 3GPP TS 32.312 [7]. 
This inheritance is by the FileTransferlRP IOC of 3GPP TS 32.342 [15] inheriting from the 
IVIanagedGenericIRP IOC. The corresponding binding is linked to a port of the FileTransferlRPService as 
indicated in the table above. 



C.2.2 Operation parameter mapping 



The FT IRP IS (3GPP TS 32.342 [15]) defines semantics of parameters carried in the operations. The tables below show 
the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

C.2.2.1 Operation listAvailableFiles 

C.2.2. 1 .1 Input parameters 

Table C.2.2. 1.1: Mapping from IS listAvailableFiles input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


managementDataType 


managementDataType 


M 


beginTime 


beginTime 


M 


endTime 


endTime 


M 
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C.2.2.1 .2 Output parameters 

Table C.2.2.1. 2: Mapping from IS llstAvallableFiles output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


f ilelnf oList 


f ilelnf oList 


M 


status 


status 


M 



C.2.2.1. 3 Fault definition 

Table C.2.2.1. 3: Mapping from IS listAvailableFiles exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


invalidTimes 


InvalidTimes 


M 



C.2.2.2 Operation fileDownloadlndication 

C. 2. 2. 2.1 input parameters 

Table C.2.2.2. 1 : Mapping from IS fileDownloadlndication input parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding input message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


f ilelnf oList 


f ilelnf oList 


M 



C.2.2.2.2 Output parameters 
Table C.2.2.2.2: Mapping from IS fileDownloadlndication output parameters to SS equivalents 



IS Operation parameter 


SS WSDL type sub-element 

used in corresponding output message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


status 


status 


M 



C.2.2.2.3 Fault definition 

Table C.2.2.2.3: Mapping from IS fileDownloadlndication exceptions to SS equivalents 



Assertion name 


SS WSDL type enumeration value 

used in corresponding fault message 

under corresponding port type operation 

as indicated in Table 5.1 


Qualifier 


InvalidFileInf oList 


InvalidFileInf oLi St 


M 
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C.3 Solution Set definitions 
C.3.1 WSDL definition structure 

Clause C.3. 2 provides a graphical representation of the FT IRP service. 
Clause C.3. 3 defines the services which are supported the FT IRP agent. 

C.3.2 Graphical Representation 

The WSDL structure is depicted in Figure C.3.2 below, depicting port type, binding and service. The port type contains 
port type operations, which again contains input, output and fault messages. The binding contains binding operations, 
which have the same name as the port type operations. The binding connects to a port inside the service. 
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Figure C.3.2: File Transfer IRP SOAP Solution Set WSDL structure 



C.3.3 WSDL specification 'FTRPSystem.wsdl' 

<?xml version="l . 0" encoding="UTF-8" ?> 
< ! - - 

3GPP TS 32.346 File Transfer (FT) IRP SOAP Solution Set 



<def initions xmlns="http : //schemas .xmlsoap .org/wsdl/" 
xmlns : soap="http : //schemas .xmlsoap .org/wsdl /soap/" 
xmlns : fTIRPSystem="http : //www. 3gpp .org/f tp/ specs /archive/ 3 2_se 
xmlns : fTIRPData="http : //www. 3gpp .org/f tp/ specs /archive/ 3 2_seri 
xmlns :xf i="http : //www. 3gpp .org/f tp/ specs/archive/ 32_series/ 32 
xmlns :genericIRPSystem="http : //www. 3gpp .org/f tp/ specs /archive/ 
xmlns :ntf IRPNtf System="http : //www. 3gpp .org/f tp/ specs /archive/3 
em" targetNamespace="http : //www. 3gpp .org/f tp/specs/archive/32_i 

< import 
namespace="http : //www. 3gpp .org/f tp/specs/archive/32_series/32 . 
< import namespace="http : //www. 3gpp .org/f tp/ specs /archive/ 3 
<types> 

< schema targetNamespace="http : //www. 3gpp .org/f tp/ specs 
xmlns="http: //www.w3 . org/2 1/XMLSchema " > 

< import namespace="http : //www. 3gpp .org/f tp/ specs/a 
<!-- The following types are defined for the File 
<simpleType name="OperationStatusTwo" > 
<restriction base="string" > 

< enumeration value="OperationSucceeded"/> 
< enumeration value="OperationFailed"/> 
</restriction> 
</simpleType> 

<complexType name="FileInfo" > 
<sequence> 

< element ref ="xf i : f ileLocation"/> 
<element ref ="xf i : f ileSize"/> 
< element ref ="xf i : f ileReadyTime"/> 
< element ref ="xf i : f ileExpirationTime"/> 
< element ref ="xf i : f ileCompression"/> 
<element ref ="xf i : f ileFormat"/> 
</sequence> 
</complexType> 



ries/32 . 346#FTIRPSystem" 

es/32 . 346#FTIRPData" 

346#fTIRPIOCs" 

32_series/32 . 316#GenericIRPSystem" 

2_series/32 . 306#Notif icationlRPNtf Syst 

series/32 . 346#FTIRPSystem" > 

3 6#Not if icationlRPNtf System" /> 
2_series/32 . 316#GenericIRPSystem"/> 

/archive/32_series/32 . 346#FTIRPData" 

rchive/32_series/32 . 346#fTIRPIOCs"/> 
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<complexType name="FileInfoList" > 
<sequence> 

<element name="f ilelnfo" type="fTIRPData : Filelnfo" minOccurs="0" 
maxOccur s = " unbounded " / > 

</sequence> 
</complexType> 

<!-- listAvailableFiles Request- -> 
< element name=" listAvailableFiles" > 
< c omp 1 exTyp e > 
<sequence> 

< element ref ="xf i :managementDataType"/> 

<element name="beginTime" type="dateTime" minOccurs="0"/> 
<element name="endTime" type="dateTime" minOccurs=" 0"/> 
</sequence> 
</complexType> 
</element> 

<!-- listAvailableFiles Response --> 
< element name="listAvailableFilesResponse" > 
<complexType> 
<sequence> 

<element name="f ilelnfoList" type="fTIRPData : FileInfoList"/> 
<element name="status" type="fTIRPData :OperationStatusTwo"/> 
</sequence> 
</complexType> 
</element> 

<!-- listAvailableFiles Fault --> 
< element name="listAvailableFilesFault" > 
<simpleType> 

<restriction base="string" > 

< enumeration value="InvalidTimes"/> 
< /restrict ion> 
</simpleType> 
</element> 

<!-- f ileDownloadlndication Request--> 
< element name="f ileDownloadlndication" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="f ilelnfoList" type="fTIRPData : FileInfoList"/> 
</sequence> 
</complexType> 
</element> 

<!-- f ileDownloadlndication Response --> 
< element name="f ileDownloadlndicationResponse" > 
<complexType> 
<sequence> 

<element name="status" type="fTIRPData :OperationStatusTwo"/> 
</sequence> 
</complexType> 
</element> 

<!-- f ileDownloadlndication Fault --> 
<element name="f ileDownloadlndicationFault" > 
<simpleType> 

<restriction base="string" > 

<enumeration value="InvalidFileInfoList"/> 
< /restrict ion> 
</simpleType> 
</element> 
</schema> 
</types> 
<message name="listAvailableFiles" > 

<part name= "parameter" element="fTIRPData : listAvailableFiles "/> 
</message> 
<message name="listAvailableFilesResponse" > 

<part name = "parameter" element="fTIRPData : listAvailableFilesResponse"/> 
</message> 
<message name="listAvailableFilesFault" > 

<part name= "parameter" element="fTIRPData : listAvailableFilesFault"/> 
</message> 
<message name="f ileDownloadlndication" > 

<part name= "parameter" element="fTIRPData : f ileDownloadIndication"/> 
</message> 
<message name="f ileDownloadlndicationResponse" > 

<part name = "parameter" element="fTIRPData : f ileDownloadlndicationResponse" /> 
</message> 
<message name="f ileDownloadlndicationFault" > 

<part name= "parameter" element="fTIRPData : f ileDownloadlndicationFault "/> 
</message> 

<portType name="FileTransf erIRPPortType" > 
<operation name=" listAvailableFiles" > 

< input message="fTIRPSystem: listAvailableFiles "/> 
<output message="fTIRPSystem: listAvailableFilesResponse"/> 

<fault name="listAvailableFilesFault" message="fTIRPSystem: listAvailableFilesFault"/> 
</operation> 
<operation name="f ileDownloadlndication" > 

< input message="fTIRPSystem: f ileDownloadIndication"/> 
<output message="fTIRPSystem: f ileDownloadlndicationResponse" /> 
< fault name="f ileDownloadlndicationFault" 
message="fTIRPSystem: f ileDownloadlndicationFault "/> 
</operation> 
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</portType> 

<binding name="FileTransf erIRPBinding" type="fTIRPSystem: FileTransf erIRPPortType" > 

<soap : binding style=" document" transport ="http : //schemas .xmlsoap .org/soap/http"/> 
<operation name="listAvailableFiles" > 
<soap : operation 
soapAction="http : //www. 3gpp . org/ ftp/ specs/archive/ 32_series/ 32 . 34 6#listAvailableFiles" 
style= " document " / > 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
</ output > 
< fault name="listAvailableFilesFault" > 

<soap:fault name="listAvailableFilesFault" use="literal"/> 
</f ault> 
</operation> 

<operation name="f ileDownloadlndication" > 
<soap : operation 
soapAction="http : //www. 3gpp . org/ ftp/ specs/archive/ 32_series/ 32 . 34 6#f ileDownloadlndication" 
style= " document " / > 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
< /output > 
< fault name="f ileDownloadlndicationFault" > 

<soap : fault name="f ileDownloadlndicationFault" use=" literal "/> 
</fault> 
</operation> 
</binding> 
<service name="FileTransf erIRPService" > 

<port name=" FileTransf erIRPPort" binding="fTIRPSystem: FileTransf erIRPBinding" > 
<soap : address 
location="http : //www. 3gpp . org/ ftp/ specs/archive/ 32_series/ 32 . 346#FileTransf erIRP"/> 
</port> 

<port name=" Generic IRPPort" binding="genericIRPSystem:GenericIRPBinding" > 
<soap : address 
location="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 316#GenericIRP"/> 
</port> 

<port name="Notif icationlRPNtf Port" binding="ntf IRPNtf SystemiNotif icationlRPNtf " > 
<soap : address 
location="http : //www. 3gpp .org/f tp/ specs/archive/ 32_series/ 32 . 306#Notif icationlRPNtf "/> 
</port> 
</service> 
</def initions> 
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